home *** CD-ROM | disk | FTP | other *** search
/ Hardcore Gamer Resource Kit / Hardcore Gamer Resource Kit - Disc 1.iso / tools / texture_utils / pcx2wal2.txt < prev    next >
Text File  |  1998-01-16  |  3KB  |  70 lines

  1. PCX2WAL.EXE tool to create .wal textures for Quake2 (ver 2.0, DOS & Win32)
  2. by Iikka Keranen (c) 1997-1998
  3. ikeranen@raita.oulu.fi
  4.  
  5. Thanks to Carl "Zep" Frendzel for Win32 binary and help cleaning up the code :)
  6.  
  7. NO TECH SUPPORT PROVIDED!
  8.  
  9. Supports all features of .wal files, including default flags, contents and
  10. values for QE4. The source code is included and is trivial to compile. It
  11. compiles with DOS GCC (DJGPP) as is, and in LCCwin32 by one change (memory.h
  12. instead of mem.h). It should be easy to do any unix port with GCC. There are  
  13. binaries for DOS and Win32 included (pcx2wal.exe and pcx2w32.exe).
  14.  
  15. What's new:
  16. - Added -p option to speed up things when no need to convert palette
  17. - Output name is now optional (-o), uses the .pcx file's name by default.
  18. - Made possible to convert multiple textures at once. It should understand
  19.   even wildcards.
  20. - Cleaned the source code a little... Ridded the dead savepcx etc.
  21. - The texture's name is now taken from the .wal file name... This might
  22.   cause uppercase problems?
  23. - Wrote flags below.
  24.  
  25. Usage:
  26. PCX2WAL <texture.pcx> [texture2.pcx] [texture3.pcx] ... [options]
  27.  
  28. (Mass-op example: pcx2wal *.pcx -p)
  29.  
  30. Options:
  31. -o <output.wal>  : Set the output file. By default, it's made from the
  32.                    source file name, e.g. foo.pcx -> foo.wal
  33. -n <animation>   : set next animation frame... like anim0, anim1, anim2..
  34. -f <flags>       : set default flags for texture (see qe4 for flags)
  35. -c <contents>    : default contents (solid/water etc... again see qe4)
  36. -v <value>       : default value (for lights .. flags&1 is light)
  37. -p               : Ignores palette, use if your .pcx has Q2 palette already.
  38.                    This makes it run 3 times faster.
  39.  
  40. Surface flags (simply add together to combine effects... 8+16 for water etc):
  41.   1: Light   - this makes the texture emit light.
  42.   2: Slick   - sets the surface slippery.
  43.   4: Sky     - show sky instead of a texture here
  44.   8: Warp    - for liquids
  45.  16: Trans33 - transparent surface
  46.  32: Trans66 - transparent surface (less transparent than trans33)
  47.  64: flow    - moving texture?
  48. 128: nodraw  - makes the engine not draw the polygon. (use for skies with 4?)
  49.  
  50. Content flags:
  51.   1: solid
  52.   2: window
  53.   4: aux (unused)
  54.   8: lava
  55.  16: slime
  56.  32: water
  57.  64: mist
  58.  
  59. PCX2WAL requires a file "palette.pal" to run. It's a 768-byte piece that can
  60. be extracted from a 256c PCX file (e.g. game screenshot) with the included
  61. PCX2PAL.EXE.
  62.  
  63. Place the resulting .wal files in quake2/baseq2/textures/mytex/ or something
  64. similar. Please use an UNIQUE dir name instead of "mytex" if you are going
  65. to distribute the textures, to avoid texture name collisions.
  66.  
  67. You may use this program and source code for anything you want, if you give
  68. me the credit for doing it first. If you're a coder and doing another texture
  69. utility based on this, I might answer code-related questions if I find time.
  70.